Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / PostScript Imaging Messages

GXPostScriptGetStatusText

QuickDraw GX sends the GXPostScriptGetStatusText message to query the printer's status channel. You can override the GXPostScriptGetStatusText message to add your own handling to the receiving of status strings from the printer. Your override of the GXPostScriptGetStatusText message must match the following formal declaration:

OSErr MyPostScriptGetStatusText (Handle statusTextHdl);

statusTextHdl

A handle to the data that is output from the printer's status channel. The first long word in the data is treated as the length of the text.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the GXPostScriptGetStatusText message to retrieve the status string from the printer's status channel. This message is sent by the default implementation of the GXOpenConnection and GXDumpBuffer messages. It informs QuickDraw GX of the current state of a printer.

The default implementation of this message issues a PAPStatus call and uses the information stored in the desktop printer to find the device. If the connection is already opened, the default implementation uses the current AppleTalk connection.

QuickDraw GX allocates a handle to 512 bytes for the status information. You can resize this handle as needed to change the size. The format of the handle is as follows:

{
   long byteCount;
   char data[];
} **handle;

The value of the byteCount field must be less than or equal to the size of the handle.

SPECIAL CONSIDERATIONS

You can partially override the GXPostScriptGetStatusText message to add special handling to the default implementation. If you are not using a PAP connection, you must totally override this message.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

The default implementation of the GXPostScriptGetStatusText message can also return the communications errors that are listed in Table 4-2 on page 4-42.

SEE ALSO

The GXOpenConnection message is described on page 4-131.

The GXDumpBuffer message is described on page 4-142.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help